Release 10.1A: OpenEdge Development:
ProDataSets

Getting the handle to a static ProDataSet

Later you’ll learn how to create a dynamic ProDataSet that you access through its handle. In the meantime, it is important to know that you can access the handle of a static ProDataSet in the same way that you can for other Progress objects. To get an object handle to a static ProDataSet, you simply assign the ProDataSet’s HANDLE attribute to a variable of type HANDLE:

Syntax

handle-var = DATASET dataset-name:HANDLE.

In the case of the sample ProDataSet:

DEFINE VARIABLE hDSOrder AS HANDLE NO-UNDO. hDSOrder = DATASET dsOrder:HANDLE.

Through the handle to a ProDataSet, you can access all its attributes and methods, along with its sub-elements (its temp-tables, queries, buffers, relations, and so on.) and their attributes and methods.

As we go along, you will learn the new object attributes defined for the ProDataSet. Standard Progress object attributes that are valid for ProDataSets include:

ADM-DATA
DYNAMIC
HANDLE
INSTANTIATING-PROCEDURE
NAME
NEXT-SIBLING
PRIVATE-DATA
TYPE
UNIQUE-ID